Historic,  Archive  Document 

Do  not  assume  content  reflects  current 
scientific  knowledge,  policies,  or  practices. 


AD-33  Bookplate 

(1H3» 


NATIONAL 

A 
Q 
R 
I 
C 

u 

L 
T 
U 
R 
A 
L 

LIBRARY 


JLA'P^A~rT€. 


(SL)OC6 1/ / 


TcCHNxCAL  ^ A N 0 A «- 
Tiie  SNR  4 aT  c.R  R cSuUkCc  RESEARCH 
Cu^PUT  EkI^Eg  „AT  A ’•  ANAGc^tNT  uTiTd 
-_aP  lATTE  RIVER  t.  ATErtotiE 


FOR 

CENTER  CWRRS)  - 
Co  OR  S J VERSION 
u P R U J c C T 


v 3.  2 


written  by  Kenneth  Signor  el lo 
Editors;  ohories  P.  Ciaii*  ur.  ^arlton  M*  Renton 

o 6 J u 1 81 


US.  DEPT.  OP  AGRICUL". 

NATIONAL  AGRICULTURE'S 

Wf  5W 


CATALOGING 


u)  & 


.rf.li 

'A  .c&V  ’■ 


ml  m 


► 


TER 

’TER 

PTEk 

’TER 
3 T crv 


a.\RC  - oGiiPjTc''xZcD  jATh  MANAotMENT  3 J 3T  {. C U f ; S ) V j • *1 

Technical  oystero  Manual  - j6  Ju 1 3a 
TAS^-c  01  COM  ENTS 


a J RjOuCi  I u '• 


TFt  HARDWARE 


2.1  DIGITAL  MlNC  P0P-1a/v3 

2 • 2 DIGITAi.  V T 1 j 5 TERMINAL 

a:  . o NUMQNICS  122*+  uIoITI<-rk 

cm**  uECWRITEkuIi  • * • • 

cm  5 hP  7221S  PLOTTER  • • • 

c m o DEC  SYSTcM  2w/t>0  • • • 


3 THc  uQmPUTcR  OPERATING  SYSTEMS 

3 • .*.  * T - 1 ^ VERSION  38  • • • • • • • 

3.2  T0PS-2j  VERSION  4 


3-1 
3-  1 


t oENERAl  of jT  ORGANIZATION 


5 

5 mi 
3.1.x 
3 . X . 1 . X 
5 *1 *1 .2 

3 . 1 . 1 . 3 

3.1.2 

s . i • 2 . x 

5 . 1 • 2 • 2 
3*1.3 

.1 *3*1 
•1*3*2 

3 .1 .3. 3 

3*1.1. A 

3*1.4 

ti  m m.  . A . 1 

5 . 1 • 4 • 2 
i .x  . 4 . j 
3 * 1 • *t  • 4 
3 • x • 4 • 5 
^ . 1 . 4 . o 

3 . i . 4 . 7 

5.1.3 


R I N C-  i i /G  3 TE CH MC AL  S t 5 T E H ORGANIZATION 

SOURCE  MQOoLc  DESCRIPTIONS  AND  PROGRAM  LuGiC  FlO*  5-1 


oouisofi  Areas  5-2 

STRING  Common  ................  5-1 

l Ab  Cosiiaon  ..................  3-2 

JUNK  Common  ••.••...••.......5-3 

Main  Line  And  alock  oata  ............  5-3 

.■lain  Line 5-3 

aloctc  Liata  • • • . • . . • • • • • • . • • . . 5-6 

Anput  And  Editing  Routines  • • • • . • • • • * • 5-3 

iNEGNL  - General  Input  And  editing  5-6 

.HcLA'6  - Input  And  Editing  For  Lab  Data  ...  5-8 
xNPPCP  - Input  And  Editing  For  Precipitation 
uata  .....................  5-8 

INcFlW  - Input  And  Editing  "cr  Plo*  uata  . . . 5-c 

uata  Reporting  Routines  5-5 

aPGNkL  - General  Reporting  Routine  • 5-8 

kPlSWN  - Monthly  Lab  Report  5-8 

A PL  SUN  - Unusual  Valuer  »_ab  uata 5-8 

RPLBWK  - Weekly  Mean  Lab  Data 5-8 

RPPCMG  - Monthly  Precipitation  Gauge  Report  . 5- S 

APPCMW  - Monthly  Pr ec ip i ta tion  Watershed 
Report  . • • • • • • • • • » • • • • • * « * * “ 

kPPC*W  - Weekly  Precipitation  watershed  report  5-9 
uata  Qumping  Routines  5-9 


o.i  r\j  (\J 


c 


>TEk 
N 0 i X 
. NCIX 
■NDiX 
NCxX 


• j.  • o Routines  For  Starting  New  x*ata  Disks 5-9 

.1.7  Data  uinut  Modification  Koutine  - Subroutine 

M G D L i M 5-9 

• j.  • a Miscellaneous  routines  

.4  rl 4-5  AND  FwGPPl  uISK  QlSCRiPTIuNS 

• 2.x  oLUE  - Development  System  uisk  ........  5-^2 

.2.2  oREEN  - COM  S Source  Programs  •••••••••  3-*. 

.2.3  GRmNjE  - Jser's  System  Disk  3-x 

.2.3.1  Audit  File 5-*. 

.2.3.2  ^ata  ^ltoit  Files 3-i3 

• ^ • a u 0 c Q ~ Data  Disks  . . . . . . . . . . . . . . o— xh 

.2*4.1  l30  Data  . . . . . . . . • . . . . . . . . . 

• <: . 4 • s Flo*  Data  • • • • • • • • • • 3 - IS 

•^•4.o  Precipitation  data  • ......  o-~7 

• 3 OTxlxT  l P RGG  f\  AM  S 5-x7 

.3.1  CRc  AGO  - Create  Audit  File  • • • • . • • • • . o - . 7 

.3.2  CficU’l  - Create  i-isiit  Files o-x7 

.3.3  kDcIMT  - Read  Data  Limit  'lie  ........  5 - x S 

.3.4  PRJC*L  - Project  Calender  Generation  Utility  . 5-x8 


o 5 u <ii;/6u  T ECHnIu  Al  SYSTEM  C *G  ANIZATION 
A LITERATURE  CiT  EG 

SUBPROGRAM  GEFiNxTIGNS 

C « T L I o - aIoRARY  GF  VT10G  DRIVING  ROUTINES 

0 sYsTcM  SGBRGuTiNE  lIoRAR  Y 


(V)  ro  ro 


u h h P T £ k _ 


I uTkGwUC  T l u h 


The  oooputerized  Data  Management  System  CCuMS)  is  a 
system  designed  to  capture,  process,  and  generate  reports  on 
data  from  the  uupiatte  River  watershed  Project  (see  note). 
The  system  was  designed  and  iiap  lemen  te  d by  the  author  of 
this  document  to  meet  the  specifications  supplied  directly 
o y Donald  W • Meals  Jr.  and  indirectly  by  or.  E.  Alan 
Cassel • jupePtf ision  has  seen  furnished  directly  oy  Charles 
P.  Ciaii  and  indirectly  by  Dr.  Carle  ton  Newton. 

The  data  input,  initial  verification,  ana  some  within 
year  processing  takas  place  on  a Digital  MlhC  PDP-i a/G 3 • 
Tnis  is  presently  located  at  ^.6  Colchester  a v e • The  data  is 
periodically  transfered  to  a bEu  2 /6C  co»put=r  where  it  can 
be  further  processed  and  stored  on  tape.  The  DEC  20/60  is 
located  at  the  Academic  Computer  Center  (aCu)  of  the 
University  of  Vermont,  in  the  Cook  sciences  ouiidina. 

The  following  chapters  will  explain  each  of  the  system 
components  and  how  they  integrate  to  form  the  COMS. 
?roarafflfliinq  conventions  will  oe  explained  in  detail.  This 
will  make  it  possible  for  a nontechnical  system  manager  to 
correct  minor  propleis,  and  for  a programmer  (using  internal 
d oc umen ta ti on J to  easily  locate  code  sections  and  make 
modifications. 


N uT  c 

The  uapiatte  reiver  watershed  project  ”is  a twelve 
year  project  designed  to  achieve  watershed 
protection  and  water  quality  improvement.  The  stud, 
is  a cooperative  effort  of  three  groups.  The  U.S. 
Department  of  Agriculture  - soil  Conservation 
Service,  The  university  of  Vermont  school  of  .»atural 
Resources  - Vermont  Water  Resource  Research  ^ent^r, 
and  The  Winooski  Natural  Resources  Conservation 
District.” (1) 
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CHAPTER  2 
T r.  E HARDWARE 


The  purpose  of  tnis  chapter  is  to  define  each  hardware 
component  of  the  system,  and  tneir  interrelat  ionships. 
Detailed  instructions  on  setup  and  use  can  oe  found  m the 
System  user's  GuideCS.)* 


2.1  Dlbli  AL  M i ft C PuP-il/^.  3 


The  micro  computer  *hich  handles  all  data  entry, 
verification,  editing,  monthly  and  yearly  reports.  -t  also 
s^nas  aggregated  data  to  the  DEC  20/6C  for  permanent  storage 
and  farther  processing. 


2.2  oIGITAL  VT10S  TERMINAL 

This  is  the  console  terminal  to  the  WING.  almost  all 
interaction  between  the  user  and  the  computer  occurs  through 
this  terminal* 


2.3  n U ft 0 N I a S 1224  0 iall 1 2 ER 

The  digitizer  is  used  to  trace  fio*  charts  and  input 
the  flow  value  at  tne  mid  point  of  each  hour. 
characters  are  sent  to  the  MIi,C  via  an  KS-232  interface  and 
then  processed  oy  the  COM2. 


2-1 


V 


£ - COMPUTERIZED  DAI  lANAGtMENT  STSTf 

System  Technical  Manual  - 06  Jui  cl 


2.4  D EcWk  IT  £K  IIj. 

This  is  the  printer  for  the  wlMC.  it  is  used  for  all 
haro  copy  reports*  When  connected  to  the  system  it  is  the 
system  line  printer. 


2*5  HP  7 cZIS  PcQTTtR 

m ^ien  plotter  which  is  used  for  graphic  display  of 
stored  data.  It  is  connected  to  the  UNO  as  a multi 
terminal.  Not  implemented  unoer  V3.2. 


2.6  UuO  oYSTEM  2 0 / t> 0 

This  is  the  main  frame  computer  ^nich  receives  the 
a^jre^ated  data  from  the  MlhC.  Once  transfered*  the  oata  is 
stereo  on  magnetic  tapes.  Further  statistical  processing 
can  then  oe  carried  oat  on  the  20/60 . Net  implemented  under 

V 3 • c • 
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CHAPTER  3 

i He  COMPUTcR  OPERATING  SYSTEMS 


ihis  cnapttr  contains  a brief  description  of  RT-ii  anj 
TuP3-eG*  the  operating  systems  on  the  MiNC  and  ZL/b'L 
raspectivei y . 


3 • i R T - 1 i V t k 3 1 0 N j6 

This  is  tie  PQP-il/03  operating  system.  It  is  a single 
user  computer  system  which  serves  the  needs  of  both 
beginning  and  advanced  programer.  it  provides  a 
comprehensive  set  of  operating  commands  that  programmers  at 
ail  levels  use  to  control  system  operations.  (c)  It  enables 
the  system  developer  or  manager  to  do  fiAe  isianipulat  ions  * 
program  compiling*  1 i nk- 1 oauing > anc  program  execution.  for 
a detailed  description  of  the  interactive  commands*  s.steai 
components*  and  utilities  see  Rl-pi  y£££.l5  ayiga  (5). 
This  and  otner  related  documentation  should  oa  located  in 
tne  near  vicinity  of  the  A INC • 


3.2  T 0 P S - 2 0 y £ R S 1 0 N 4 

This  is  the  operating  system  for  the  DcC  SYSTEM  2u26( • 
It  is  accessed  by  the  CDMS  from  the  MXMC  when  file  transfer 
is  carried  out.  inis  is  handled  exclusively  by  the  M1NC 
component  of  the  CQM5*  The  user  must  establish  the  hardware 
connection  via  a modem*  but  tne  MiNC  portion  of  the  CJ‘ j 
performs  the  interaction. 

TOPS-Zd  is  rurtner  used  independently  of  tne  !xNC 
portion  of  the  COM3  to  perform  file  storage  and  retrieval 
from  magnetic  taoe  and  across  year  statistical  data 
processing.  for  further  information  about  TQPS”2t  ae<_  the 

Ik£i“i.L  Uiidi  Suias  C73  and  IQEi”2k  tkflasaQd  &£t£C£Q££ 
Maoyji.  (6).  ror  more  information  on  its  usage  in  tne  Co  3 
see  chapter  6. 
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The  logical  organization  of  the  system  is  illustrated 
in  figure  1.  Ifou  will  note  that  tnere  are  two  sajor 
components  to  tne  system*  the  M.iNC  and  20/6-0  components* 
The  communication  wnich  occurs  Detweeh  these  components  is 
strictly  a one  way  transfer  of  data  from  the  MINC  to  the 
20/60*  This  occurs  periodical^  when  ail  tne  data  for  a 
given  month  has  been  entered. 

The  functions  which  occur  on  the  MING  are  all 
controlled  oy  a single  FuRT RAN/ MACRO  program  on  that 
computer*  A user  of  this  component  of  tne  system  need  not 
be  experienced  «ith  computers*  <«hiie  a user  of  the  20/60 
component  of  th<=  system  must  be  somewhat  familier  with 
TuPo-20  ana  available  software  packages*  The  functions 
illustrated  in  figure  ± are  greatly  generalized  and  will  be 
described  in  greater  detail  in  following  chapters*  The 
functions  that  will  occur  on  the  20/60  have  not  been 
established  under  version  3*2*  and  will  not  be  discussed  in 
any  detail  in  tnis  document* 

The  overall  flow  of  data  through  the  system  is  depictec 
in  -igure  2*  The  aim  of  the  system  is  to  merge  logically 
related  data*  originating  from  diverse  sources  Anto  a 
physicaiy  reiateo  data  base*  Verification  of  the  uata  ia 
performed  during  this  process* 

The  MlftC  portion  of  the  uDMS  does  all  data  input  anu 
verification.  Data  is  then  merged  into  monthly  unit j which 
are  transfered  to  the  2G/oO*  There,  utility  programs  will 
iser  je  the  monthly  units  into  yearly  tiles  ana  store  them  on 
magnetic  tape*  Further  processing  of  the  data  can  be 
performed  on  the  20/ou  by*  as  of  yet  unspecified  process^n^ 
systems* 
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Fig.  1.  Overall  Logical  Organization  of  CDMS. 
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ig.  2.  Overall  Data  Flow  Through  CDMS 


4-3 


v/riMp  7 5k  5 


d i du-  i i/5  i TECHNICAL  STfSTcM  ThGANiZAT  ..DM 


As  mentioned  aoove#  all  data  handling  on  the  ^NC  is 
pertormed  by-  one  menu  driven  program.  Inis  chapter  contains 
detailed  uoc ufflentdtion  of  the  program  nodules*  programing 
conventions*  file  naming  conventions*  ana  utility  programs. 
This  documentation  mill  consist  of  flow  charts*  module 
definitions*  and  variable  and  common  ares  descriptions. 


5.1  oOURu£  MuDuLt  OtSCRIPTIGwS  AnO  PROGRAM  LoG^C  FLOW 

nil  subprograms  are  listed  in  appendixes  8*  C*  ana  0. 
These  can  be  grouped  into  tne  following  sets J 

Mam  Line  and  uLuCK  DATA; 

input  and  editing  routines; 

uata  reporting  routines* 

- uata  dumping  routines; 

routines  which  allow  the  user  to  start  a ne.  data 
disk; 

- A single  routine  which  allows  lab  data  iimit 
modification*  and 

Those  routines  which  perform  single  functions  which 
are  used  in  more  than  one  of  the  aoove  groups. 
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5.1.1  common  Areas 

There  are  3 labeled  common  ar  e a s i $TR  u , u Ao  , and 
JUNK.  The  contents  of  each  are  described  belo^. 


5.I.1.1  aikido  Common  - 

This  common  urea  contains  a ngaiocr  at  character  strings 
used  througnout  the  program.  Tnese  are  listed  ana  described 
in  Table  i . 


Table  i - oTRlhG  Common  Variables 


V ar i able 

Type 

dimension 

description 

ANo 

1*1 

Used  for  input  of  all  single 
character  answers  supplied  oy  user 

oc  uL 

L*i 

Contains  C T R L / G (oell  character; 

uLAckR 

L *1 

16 

An  escape  sequence  *hich  saves 
the  current  cursor  position, 
clears  the  error  line,  and 
returns  to  the  saved  position. 

F I a N A M 

- ^ i 

11 

Holds  a single  file  name. 

iO  AT  t 

i -*1 

9 

Holds  current  date. 

MQNTn 

L*1 

4 

String  variable  ahich  contains 
a user  supplied  month  abbreviation 

MONTH S 

o 7 

Characters  for  all  month 
abbreviations 

V G L I U 

12 

Holds  12  character  Volume  lu . 

5. 1.1.2  *.A8  Common  - 

This  common  area  contains  data  relevant  to  tne  lab 
data.  This  includes  such  tnings  as  file  format  information, 
info mation  about  data  fields*  and  descriptive  text.  Tnese 
are  listed  and  described  in  table  2. 
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Table  2 - i_m8  Common  Variables 


Variable 

Type 

u imens ion 

description 

EDI  AftM 

JL 

1 *♦ » 3 

Data  number  for  each 
in  each  lab  series. 

data  field 

F L a N A M 

a*. 

10  # --4 

This  array  contains  tne  names 
of  each  of  the  z 4 lab  parameters 

ft  M R E 0 S 

1 

3 

The  maximum  number  of 
each  iaD  series  file. 

records  in 

RECLEN 

i. 

3 

The  record  length  for 
series  file. 

BclCh  JL  cl  D 

5.1  *1.3  JUNK  Common  - 

This  common  ilock  is  used  as  a buffer  bloc*.  It 
contains  5634  «orcs»  and  is  equivalenced  to  variables  of  tne 
size  an j type  neeaea  in  the  individual  routine. 


5.1.2  1'iain  ^ine  And  Block  data 
5 . 1 • 2 • 1 Main  Line  - 

The  Main  Line  logical  f lo a is  illustrated  in  Figure  3. 
It  serves  3 major  functions^  displaying  tne  M * I ft  .ichUf 
makin^  entries  into  tne  Audit  file*  ana  calls  the  proper 
subroutine  wnich  controls  the  selectee  MAiN  Meftu  function. 
Tne  major  subroutines  called  are! 

He  Au  XNEGNl  RPbftRv.  DMPuNi.  He  W i)  S K.  MOOLI h 

These  are  desenoed  in  nopendu  o.  Major  variables 
used  are  listed  in  Table  3. 
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Taoie  3 - Main  tine  Variaoles 


Var lobie 

T ype 

u im  en  s ion 

description 

BLANK 

I 

Characters;"  * 

CCnLr 

X 

Characters;  Carriage  return* 
Line  feed 

GENRcP 

I 

9 

Cnaracters  i“GtNtR-tTcO  REP  uR. TS‘J 

iOmTc 

I 

5 

Contains  da  te  i dd-mnira- y y 

1NEDTA 

I 

12 

Text  I**  INPUT  AND/OR  cDiTcO  ..I,," 

IT  1 wc 

I 

A 

Contains  ASCII  time;  hhSmmlss 

uOG  In 

X 

6 

Text;  "Logged  in  -n 

L G L»  0 o T 

I 

6 

Text;  "Logged  out-'* 

URN 

I 

The  last  record  number  in  tne 
Audit  file 

«URcC 

I 

The  maximum  number  of  records 
tnat  can  be  contained  in  the 
Audit  file 

MODTuM 

I 

10 

Text:"MuOIFIEb  uAT A uIMITS" 

p R u u 

L*1 

MAIN  MENU  procedure 

o T N WO  < 

T 

1 i 

Text  •"'INITIALIZED  A Nt  • DISK* 

uSkNaM 

i 

10 

The  user  supplied  name 

The  CDMS  starts  execution  in  the  Main  Line  oy  call  in  y 
toe  suoroutine  HEAD  which  displays  the  welcome  salutation. 
Tne  ,4ain  i_ine  then  a sics  the  user  for  his  or  her  name . <ext 
the  Muait  file  ij  opened*  the  last  record  nuaiber } and  the 
maximum  number  of  record  are  read  in.  The  last  record 
number  is  tnen  incremented  ana  checked  against  the  maximum 
numuer  of  allowable  records.  A record  is  then  written  to 
the  « u d i t file  indicating  the  Login  time*  date*  and  ^iven 
user  name.  The  MAIN  MENU  is  then  displayed  and  the  uesireo 
procedure  code  input  and  verified.  The  last  record  numoer 
in  the  hUiii  file  is  incremented  and  a multiple  branch 
performed  on  the  procedure  code. 

At  each  section  a record  is  written  out  to  the  uudit 
file  and  the  appropriate  suoroutine  cauea.  one  exception 
is  exiting  tne  system.  instead  of  a subroutine  jemj 
called*  the  -udit  file  is  closed  and  program  execution 
h a 1 tec . 

Normal  program  termination  is  from  tne  Iain  Lint)  out 
due  to  missing  files  or  internal  error  checking  tne  system 
may  terminate  execution  abnormally  elsewhere  in  tne  program. 

After  a return  from  any  of  tne  major  function  routines 
occurs*  the  MAIN  McNU  is  again  displaced  and  the  above 
procedures  are  executed  again.  See  figure  3 for  a araphic 
representation  of  tne  a in  i_ine  logical  flow. 
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Figure  3.  WRRC  - CDMS  MAIN  LINE  Source  Flow  Diagram 
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5 • 1 • 2*  2 oIoca  i/atd  - 

The  bi  oc<  data  serves  to  initialize  some  of  the 
variables  in  the  jTRj.No  and  la3  CC^rtCft  areas  to  constant 
vaLues  at  compile  tune.  »he  v aiuts  in  these  variables  do 
not  change  during  program  execution.  see  section  tor 

variable  aetinltions. 


5.1.3  input  Mnd  ;ditin3  Routines 

These  routines  direct  all  input  i editing*  an~ 


verification  of 

data. 

The 

major  input /editing 

routines  are  : 

I . < co  NL  * I N E - A o » 

INEPCP , 

and 

I N E r L it . 

The  logical 

f loa 

for 

the  Input / Edi tin g 

section  is 

iilus  trated  in 

figure 

Each  of  the  major 

routines  are 

discussed  belo*. 


5. 1.3.1  iNcGNc  - General  Input  And  Editing  - 

This  is  the  general  input  ana  editing  routine.  It  io 
calxed  from  the  aamiine,  displays  the  I.NPuT/EalT  n E N U * 
deter Bins  the  desired  procedare*  and  either  returns  to  the 
main  line  or  calls  the  correct  subroutine.  This  is  a very 
simple  routine  *hicn  nas  no  major  variables.  it  c5hs  the 
remaining  major  Inpat/Editing  routines  mentioned  above. 


o-  o 


* 


' 
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Fig.  4.  . WRR-CDMS  Subroutine  INEGNL  Source  Flow  Diagram. 
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5. 1.3. 2 

iNcLAo  - Input 

And 

Ec i t in  g 

For 

Lab  Data  - 

5. 1.3. 3 

1NPPCP  - Input 

And 

Editing 

For 

Precipitation  Data 

5 . 1 • 3 • 4 

1NEF..W  - Input 

And 

Editing 

F or 

Flo*  Data  - 

5 • 1 • a jaid  Reportiny  Routine  a 

These  routines  control  ail  data  reporting  on  the  . — ,,C. 
•ajor  reporting  routines  are! 

* P G n ?■  » t RP  L-<  ■ A * RPLoUN  « R P L o W K * ■ P P u M o » kPPu  i ; > and  • P P u • 

The  iOyical  flow  for  the  reporting  section  of  the 
system  is  pictured  in  figure  5.  The  major  routines  are 
discussed  b e 1 o m • 


5. 1.4.1  aPGNRL  - jeneral  Reporting  Routine  - 


5*1  .4.2  KPlSMN  - Monthly  cab  Report 


5.1 .4.3  K P c 8 U N - Unusual  Values  tao  tat j - 


5 .1*4,4  RPlBWK  - Weekly  Mean  Lab  Data 


5. 1.4,5  RPPCMG  ~ Monthly  Precipitation  Gauge  Report  - 


5.1.4. 6 RPPCMW  - Monthly  Precipitation  watershed  Report  - 
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t?. 1.4.7  kPPC»W  - Weekly  Precipitation  x/atersheo  report  - 


5 • 1 • 5 sat  a Dumping  Routines 

5.1.6  Routines  For  Starting  ft  e w u a t a Disks 

5.1.7  uata  Limit  Modification  Routine  ~ subroutine  MuO-lM 

The  logical  flow  involved  with  modifying  data  limits  is 
illustrated  in  Figure  6.  dimply*  this  routine  allows  the 
user  to  make  a change  in  the  lab  data  limit  files.  There 
are  2 data  limit  files  and  only  1 at  a time  may  be  modified. 
A password  is  required  to  make  any  changes.  Tne  r e are  no 
major  subroutines  called  from  this  suopr ogram • <ajor 
variables  are  listed  in  Table  4. 


Tacit  4 - MOLiLiM  Major  Variables 


Var iabie 

Type 

u im  en  s ion 

ijsocr  ip  1 1 on 

Cl 

i 

4 

aim  it  character^!  so*  Li*  HI*  Hu 

LIMITS 

R 

4 

The  4 data  iimitstloM  outer*  low 
inn^r*  nigh  inner*  high  outer 

tIMNUM 

1 

Indicates  which  of  4 limits  for 
a particular  variable  is  to  be 
modi fi ed 

i\  c s L i M 

R 

Tne  binary  new  data  limit 

NWcMCH 

w * 1 

10 

The  character  new  data  limit 

P AoS 

L *1 

4 

Equivalenced  to  USRPAS  to 
achieve  character  access 

PAsWRD 

R 

Stored  password 

USRP AS 

R 

User  supplied  password 

V AAMuQ 

R 

Tne  variable  mnemonic  to  oe 
modified 

VARNAM 

K 

14 

List  of  variable  mnemonics 

VARNUM 

JL 

Variable  number  to  to  be 

modi fied 

MQdLlM  is  called  fro®  the  Main  Line.  first  asks  the 
user  for  the  password.  This  is  masked  when  entered.  1 he 
user  supplied  password  is  then  checked  against  that  wni^h  is 
stored  witn  the  variable  PASWR0-.  It  an  incorrect  password 
is  given  a RETURN  to  the  Main  «_ine  is  performed. 

unce  a correct  password  is  given  tne  user  is  aswed  to 
specify  which  of  the  2 limit  files  (see  section  a.a.o.i)  he 
or  she  wishes  to  modify.  The  variable  mnemonics  are  then 
displayed  and  tne  correct  file  opened. 
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Kext  the  mnemonic  for  tne  c or  r e sp  on  di  ny  variable  ihi.cn 
is  to  be  modified  is  entered.  If  "M"  is  entered  a normal 
return  to  the  Main  cine  is  per  foraiea  at  this  point.  The 
mnemonic  is  converted  to  a number  by  searching  throu^n  a 
list  of  mnemonics.  This  corresponds  to  the  record  numo=r  in 
the  limit  file.  Tne  limits  for  the  specified  variable  tnen 
read  from  the  file  and  displayed  on  the  screen. 

ho*  the  user  specifies  wmch  of  the  4 limits  he  or  she 
wishes  to  change#  or  if  none  the  user  may  chose  another 
variable.  if  a limit  is  selected  the  current  value  is 
displayed  i>eioa  its  usual  position  and  the  user  may  enter  a 
new  value.  The  new  value  is  checked  against  the  neighbor 
values  to  oe  sure  tnat  it  is  logically  correct.  If  Di\  the 
new  value  is  entered  into  tne  file  and  another  limit  may  p e 
modified.  bee  figure  6 for  a graphic  representations  of  the 
logic  flow  for  subroutine  MOOLIM* 


Figure  .6.  WRRC-CDMS  Subroutine  MODLIM  Source  Flow  Diagram 
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5.1.8  Miscellaneous  Koutmes 

5.2  r LE  AND  FLOPPY  DISK.  OESCRiPT-UNS 

riles  are  a 1 a contain ea  on  single  sided  double  density 
floppy  disxs  each  holdina  5l2»Ulv  oytes.  All  oisks  related 
to  the  v,DM$  have  coLor  coded  laoels  which  identify  the 
contents  of  the  disk.  These  codes  are  listed  below. 


5.2.4.  oLJS  - Development  System  uisk 

This  dis«.  contains  an  kT-1*  operatins  system*  FORTRAN 
compiler*  MACRO  assembler*  subroutine  Horary*  MAuRu 
library*  KEG  editor*  and  assorted  system  utilities  used  in 
deVclcpiny  and/or  modi  f y m a tne  source  for  tne  portion 
of  the  lDmS. 


5.2.2  GREEN  ~ COM S Source  programs 

These  disks  contain  all  source  programs  relitive  to  the 
Co Mo.  There  are  two  disks  at  any  one  time*  one  contains  the 
source  for  the  most  recent  operational  version  and  the  otner 
tne  source  for  the  version  currently  oemg  developed.  These 
can  be  identified  by  the  version  number  written  on  the 
label. 


5.2.3  GRANDE  - User's  System  Disk 

The  executable  form  of  tne  COM S is  contained  on  tnis 
disk.  Tnis  is  the  disk  that  a user  would  normally  use  to 
perform  regular  system  operations.  This  disk  also  contains 
a minimum  RT-il  operating  system  (capable  of  loading  a 
program*  running  a program*  and  doing  some  file 
manipulations)*  the  Audit  file*  data  limit  files*  and  Co v a 
utility  programs. 


5 *2.3.1  Audit  File  ~ 

the  Audit  File  is  written  to  by  the  mam  line.  It  is 
an  unformatted  direct  access  file.  The  records  are  lo 
double  words  long.  The  numoer  of  records  in  tne  file  is 
determined  when  the  fixe  is  created  oy  the  CREAGb  utility 
program.  The  first  record  of  this  file  contains  the  numoer 
of  tne  next  record  and  the  maximum  number  of  records  tnat 
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can  be  contained  in  the  file. 

Ahen  a person  starts  the  system  an  entry  is  made  into 
tne  fixe  indicating  the  name  given  by  the  person  as  «eii  as 
the  time  and  date  tne  system  »as  started. 

from  that  *>oint  on*  each  time  a selection  is  made  from 
the  MAIN  MENU*  an  entry  is  mace  into  the  Audit  file 
indicating  the  operation  selected.  Tne  >'<c;in  cine  indicates 
to  the  user  wnen  the  file  is  full  and  stops  execution  of  the 
program.  At  that  time  the  system  manager  should  obtain  a 
hard  copy  of  tne  Audit  file  for  nis  fiies  and  then  create  a 
new  one  using  the  CnEAUu  utility  program. 


5.2.3. 2 uata  Limit  files  - 

cat a limit  files  are  used  for  checking  the  values 
entered  for  1 ao  data.  The  system  disk  contains  2 of  these 
files*  i for  stations  1-4*  and  1 for  station  5.  The  file 
names  are  lIMITI.DmT  and  LIMIT2.DAT.  These  are  unformatted 
direct  access  files  each  containing  24*  4 d o u o 1 e word 
records.  each  record  contains  the  low  outer*  low  inner* 
high  inner*  and  high  cuter  limit  for  a particular  data 
Parameter.  The  parameters  and  corresponding  records  are 
listed  in  Table  5. 
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Table  5 uimit  ^iie  contents 


Record 

Nuraoer 

Lab  Data  Parameter 

1 

TP  A 

2 

TRbA 

3 

bSA 

TPo 

5 

TRB8 

6 

SSo 

7 

P 0 4 P 

6 

TKN 

9 

NH  o 

1C 

N02  3 

1 1 

TVS 

12 

CQp 

- 3 

PH 

14 

uO 

i 5 

CON  D 

i.  6 

rc 

1 7 

PC 

x3 

f S 

19 

T 

<L\i 

station  number 

21 

a A i4<  P L E No M B £ R 

22 

DATE 

23 

COLLECT IuN  TIME 

£4 

o JMPOSxTE  INTERVAL 

The  limit  files  are  originally  created  oy  the  Ck£i_I' 
utuity  program.  They  can  be  modified  by  the  MOuIrY  Dat^ 
Limits  function  of  the  CDMS.  Naturally  if  the  files  are 
recreated)  any  changes  that  might  have  oeen  made  will  nave 
been  lost. 

The  data  limit  files  are  necessary  for  the  functioning 
of  only  certain  CDMS  functions.  These  areJ  Input  or  _uit 
Lab  Date*  MuDIFT  data  limits*  and  generating  tne  unusual 
Values  report  on  lab  data.  if  either  of  the  fuel  are 
missing  wniie  trying  to  execute  any  of  these  functions  the 
program  will  stop  execution. 


5.2.4  uOwQ  - Data  Disks 

These  disks  contain  data  input  through  the  Co  MS.  Each 
disx  contains  one  year's  worth  of  data.  if  tne  disi  nas 
been  started  it  will  have  tne  year  written  on  the  label. 
Tne  year  is  also  noted  in  the  volume  ID  of  the  disk.  This 
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is  oone  during  the  “Start  a new  disk  operation"  of  the 

system*  The  volume  lu  is  a ic  character  strings 

OAy y-cdmmmsy  • where  i 

u A = An  indicater  that  this  is  a data  disk 

yy  = The  year  from  which  data  on  this  disk  is  rrorn 

ddmmmsy  = The  oata  on  .-hich  this  distc  was  started 

Tne  volume  -0  can  be  obtained  witn  the  directory  commana  of 
RT-1 1 « 

There  are  3 aroups  of  files#  those  which  contain  <_ab 
data*  rlowj  data*  and  Precipitation  data.  All  of  the  files 
are  unformatted  direct  access  files.  Their  parameters  are 
listed  in  Table  6#  ana  they  are  furtner  discussed  is  tne 
following  3 sections. 

S l.LT 

Table  6 - data  file  summary  taale 

Ji.  Ian 't  justify  line 

on  output  page  5-*.5»  on  input  line  50600  of  page  a of  tne  **  u Sk  l T E C • RNu  “ 


Record  Numoer  rile  Number  Maximum 
Pile  Length  of  Size  of  Stations  riles 

jroup  Cdouole  words)  Records  Colocks)  per  file  per  Disk 
CJc  Can't  justify  line 

on  output  pa^e  5-15*  on  input  line  51000  of  page  1 of  file  "CSK  • • x •'u " 

— 

tAa  A 7 36  2 5 12 
LAB  B 13  136  20  5 12 
c Ap  C 11  3 i 7 5 a 2 
PLOW  2 4 31  6 1 60 

PRECIP  12  93  9 3 12 

LJl  Can't  justify  line 

on  output  page  5—15*  on  input  line  5160G  of  page  1 of  file  “aSktT  o.RNl'’ 


tlu  .END  L * TcRAL  doesn't  follow  .LITERAL 

on  output  pa  ^e  5-15*  on  input  line  51600  of  page  a of  file  “LrSh  I T tb  • 11 


5.2. 4.1  a o data  - 

There  are  three  types  of  lab  data*  A*  3 * and  a series. 
Tney  are  wept  in  separate  files.  Tne re  is  one  file  for  each 
month  yielding  36  files  for  lab  data*  The  file  names  are  of 


the  form  sLouimm.DrtT.  *Jhere  s is  the  series  type  v.  A , o#  or 
C)  and  maim  is  the  month  for  the  data.  The  fixes  are  all 
unfonsated  direct  access  files  *ith  different  record  lengths 
and  file  lengths  for  each  lab  scries.  These  arc  listed  in 
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table  6 . 

each  record*  regardless  or  tne  file*  contains  o 

I.«TeGcR»2  values  followed  oy  a variable  numoer  of  RcA.-*1* 
values*  I he  se  are  3*  3*  and  for  w * o and  « series 
respectively.  Tne  first  value  is  not  part  of  the  iao  date* 

but  is  used  by  the  program  to  indicate  the  logical  enu  of 
file*  all  those  records  which  do  not  have  data  on  them  h3ve 
tnis  value  set  to  a numoer  < 0*  Tne  remaining  7 integer 

values  make  up  the  Sample  iQ  for  each  sample;  <station  it  - 

Sample  v - sample  Day/Sample  Month/sample  fear  - sample  Time 
(*.4  hour  cl ocx.)  - Composite  Interval  CO  for  a Grab)>.  The 
other  data  values  are  different  for  eacn  series.  The 

contents  of  the  remaining  data  values  for  each  series  are. 


Tn  ia 


sERItS  A:  TPp*  T R 3 >-> » and  3 a A 
uEkIES  8i  T 2 b » T R 3 s » S 3 8 * P 0 <♦  P * 

and  U S U 

aixicS  Ci  pH j J J i C 0 N 0 • I To*  rCi 

The  data  is  maintained  in  sorted 
is  dona  by  the  input  and  editing 


1 X N * N ri  3* 

N 3x  » j # T v S * 

EG  » an  d 

T cMf  . 

o roer 

by  Sample 

routine 

for  lab  data 

K • 


5. 2*4*2  r 1 o w Data  — 

Flow  data  are  stored  in  5 files  per  month*  one  file  for 
eacn  station*  Tnis  fields  60  flow  data  tiles  on  eacn  disk* 
They  are  created  as  needed.  Tne  file  names  are  of  the  form; 
sfWnjfflm.DAT*  where  s is  tne  station  « and  mmm  is  the  month 
from  which  the  data  originates. 

The  files  are  unformatted  direct  access  files 
containing  31  records  each.  The  records  correspond  to  the 
days  in  tne  month.  Eacn  record  contains  24  REAL*4  values. 
These  values  are  tne  flow  rates  recorded  at  tne  midpoint  of 
each  noun.  The  relative  position  on  the  record  indicates 
tne  hour.  Hence*  the  fiow  recorded  at  1213-  on  the  5 th » 
would  be  in  the  Idtn  value  on  tne  Sin  record.  The  files  tor 
months  with  < 3s  days  have  the  values  for  tne  unusea  records 
set  to  -939.0. 

The  program  is  set  up  in  such  a mjy  that  tnese  flies 
will  always  be  completely  filled.  The  user  is  forced  to 
fill  these  fii.es  when  inputina  flow  data. 
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5.2.4.3  Precipitation  data  - 

Precipitation  data  are  stored  in  1 file  per  month. 
Tnere  are  three  stations  out  due  to  the  type  of  analysis 
that  is  done  on  this  data*  it  was  more  efficient  to  store 
all  three  stations  in  one  file.  The  file  names  are  or  the 
formi  PRCmmm.OMT  * where  aimra  is  the  month  for  this  data. 

These  files  are  unformatted  direct  access  with  93 
records  in  each  file*  3*  for  each  station.  Records  i-3i  for 
station  i*  32-62  for  station  2 * and  6 3- *3  3 for  station  3.  on 
each  record  there  are  *2  RtAL«4  values.  The  values  are  the 
amount  of  rainfall  over  2 hour  intervals  In  inches.  Stored 
values  of  -993  • l indicate  that  no  data  is  entered  in  that 
p osi ti on. 


5.3  UTILITY  PROGRAMS 

Utility  programs  are  separate  programs  used  to  perform 
functions  such  as  reading  binary  files*  recreating  data 
limit  files*  reformating  binary  files*  etc.  These  will  De 
individually  discussed  below. 


5.3.1  UR t A 00  - Create  Audit  rile 

This  utility  is  uscd  to  create  a new  audit  file  (sea 
section  5.2.3.21.  The  program  asks  the  user  how  many  blocKS 
he  or  she  would  like  to  allocate  for  the  file*  fills  the 
file  with  blanks*  and  sets  the  first  record  with  the  initial 
values  of  1,  anu  the  number  of  records  that  will  fit  in  the 
file.  This  file  is  created  on  the  device  with  logical  name 
S Y : and  destroys  the  previous  audit  file. 


5.3.2  CRcL^M  - Create  Limit  rij.es 

This  utility  program  serves  the  same  function  f»r  the 
data  limit  files  as  CRcAUQ  does  for  the  audit  file.  C RE a In 
has  a set  of  initial  values  that  it  uses  when  new  limit 
files  are  created.  Tnese  were  set  forth  early  in  the  course 
of  this  project  and  should  oe  reviewed  when  recreating  data 
limit  files.  The  files  are  created  on  the  system  dis<*  or 
the  device  with  logical  device  name  oY ;•  See  section 

5. 2.3.2  for  a description  of  the  limit  flies. 
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5.3«3  KOwIMT  - Read  data  Limit  File 

This  utility  program  is  to  oe  used  for  reading  the 
oinary  lab  data  limit  files  and  displaying  them  on  the 
console  terminal.  The  file  contents  of  LiMAT^.oAT  is 
displayed  first  followed  oy  that  of  Li^IT2.iJAT.  See  section 
5. 2.3. 2 for  a description  of  these  files.  individual  limits 
can  oe  viewed  and  modified  through  the  system  uy  performing 
tne  'MODIFY  SmT  A ,_IMITSW  function. 


3.3.4  PR^CmL  - Project  Calender  veneration  Utility 
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CHAPTER  b 

DEC  £,/60  TECnUCAL  SYSTEM  ORGANIZATION 


This  section  will  describe  20/oU  command  files*  tape 
handing  routines*  tape  iioraries*  and  any  utility  programs 
tnat  are  used  on  the  20/6v»  These  are  not  specified  unoer 
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oUdPROGRAK  DcFlMlT IONS 


This  appendix  contains  an  alphabetical  list  ana 
descriptions  of  all  subprogram  modules  in  tne  UNO  portion 
of  the  CQriS. 


rt A 1 K LiNc  - controlling  executive  program.  Makes  entries 
into  audit  file*  and  starts  controilin3 
subprograms  for  each  major  program  function. 


oLa  CK 

w41-DhT 

u R o T f L 
0 1 a p i-  W 

U I S L A 8 

uETYuL 

G R l C n R 

u A c. ib 

h£AD 

^DAYMN 

lDAYNM 


DATA  - Sets  values  of  variables  in  string  common. 

- Converts  a day  number  into  a caiander  date. 

- Creates  new  data  files  for  the  uab  data. 

- Displays  a single  flow  data  record  usind  vurxaole 
f or naa  t • 

- Displays  a single  lab  series  record  using  correct 
format  at  specified  screen  position. 

- MACRO  Subroutine  which  reads  the  volume  Ip  on  the 
data  disk. 

- :«CRC  subroutine  which  retrieves  specified  numoer 
of  characters  from  console  terminal  without  a 
Rc T u A m * 

- MACRO  Subroutine  which  retrieves  a group  of  8 
characters  from  tne  digitizer. 

- Displays  initial  message  at  system  startup  time. 

- Calculates  the  number  of  days  in  the  jivan  month 
for  tne  given  year. 

- Converts  a caiander  date  into  a day  number. 
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w RkC 


x N D I 6 

I N£  _ 
xNcGN L 

i N t L A B 
xNEPCP 
•_IMCHK 

mnthyr 

HCDLxM 

,r /.  JoK 

PRJOAT 

P JTVuL 
R P G N k L 

R P L B <*)  N 

RPLoUN 

a 3L 9k  K 

kPPCKG 

rppcmv 
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Handles  lathering  a section  of  flow  chart  xn^ut 
from  the  digiticer.  Rakes  sere  faow  values  aren't 
missed  or  repeated. 

Handles  ail  aspects  of  inputting  and  editing  flow 
data* 

General  input  and  editing  routine*  Displays 
INPUT /ED  I TING  McinU  and  determines  the  ty^e  of 
input  desired* 

Handies  input  and  editing  of  1 ao  data. 

Handies  input  and  editing  of  precipitation  data* 

Routine  winch  checks  the  lab  data  against  data 
limits  stored  in  the  limit  files* 

"unction  .ihich  obtains  month  ana  year  from  us  = r of 
data  to  be  entered  or  of  desired  reports.  Year 
and  month  are  verified#  and  data  disk  is  checked* 

Goes  modification  of  data  limits* 

Allows  user  to  start  a new  disk. 

Converts  a dajnuiiibar  into  a project  cate  - year 
number#  week  within  year#  and  consecutive  week. 

Writes  out  a volume  ID  onto  the  data  disk. 

General  report  generation  routine*  0 i splays 

REPORT  ME *U  and  determines  tne  desired  report* 

Tnis  routine  generates  the  monthly  lab  report  for 
A#  fl # and  C series  data. 

Generates  report  an  lab  data  indicating  urusuai 
data  values. 

Generates  report  on  lab  data  giving  weekly  means 
for  a specified  ran_,e  of  time* 

Monthly  precipitation  gauge  report  gener^t*.on 
routine. 

Generates  monthly  or ec ip i t a t i on  watershed  report. 

Generates  weekly  precipitation  totals  b,  »eek  for 
each  watershed. 


GY oTEM 


G U d R u U I 1 N c _ 1 dRaR  Y 


This  comprises  a group  of 
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routines  which  are  used  throught  the  C G v o out  are 
oart  of  the  RT-ii  System  Subroutine  library,  or 
par t of  FORTRAN  under  RT-li.  These  ar a listed  in 
Appendix  L • 

yTlIo  - This  is  a library  of  macro  routines  which  drive 
tne  VTl05  terminal*  These  are  descrioeo  under 
Appendix  J. 
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V 7-_  IS  - cIoRARV  OF  VT1GL  DRIVING  RuUTIhES 


VTi_lS  is  is  c t set  of  fo ACRO-ii  subroutines  which  =>r  e 

used  to  control  the  V T 1 v j or  VT10S  terminal.  These  were 

ootc.ined  through  a uiCUo  puolication  (9>.  There  nave  been  a 
few  minor  modifications  ana  additions*  but  generally  they 

are  used  as  published.  The  routines  generate  escape 

sequences  which  perform  the  desired  terminal  function.  Tne 
routines  used  are  described  below. 


oloPoT 

M akes 
height 

tne  current  line  the 
line. 

bottom  half 

of  ad  cud  e 

o Io T a P 

- 

Makes 

he  iah t 

the  current  line  the 
line. 

top  half 

o f 

a douol e 

SLOViD 

- 

Makes 

next  characters  bold 

video • < Added ) 

oNKVID 

- 

Makes 

next  characters  blinking  video 

• 

(Addedi 

u L R ALL 

- 

Cl  ear  s 

entire  terminal  screen. 

uLR8cG 

- 

Clears 

oegining  of  current 

line. 

CLK  oOT 

- 

He  ar  s 

from  the  cursor  to 

the  bottom 

o f 

screen 

0 L K E N 0 

- 

Cl  ears 

end  of  current  line 

• 

C L R L I N 

- 

Clears 

cur r en  t line. 

CR-F 

u Uo 
CUF 

CUP 


- Generates  a carriage  return  line  feed. 

- Moves  the  cursor  back  specified  number  of  spaces 

- Moves  the  cursor  forward  specified  number  of 

Sp  6 ^ • 

- Moves  cursor  to  specified  lmc  eno  column. 
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U J S 

u W L 
xNO 

ME  0 VI 0 
•\  E o V x 0 

k E S C o R 
R I 
RM 

oM 

S A y C u R 

O.j  5 

SToM 


Deselects  tne  jraphics  set  of  cnaracters 

Makes  the  current  line  double  width. 

Moves  down  one  xine  witn  scrolling. 

Makes  next  characters  negative  video. 

Makes  next  characters  regular  video.  vf orderly 
PuSVIo) 

Reset  tne  saved  cursor  parameters. 

Reverse  index  - Moves  up  - line  with  a scroll. 

Reset  mode  - resets  any  of  the  terminal  modes  e • g. 
132  column  mode. 

Set  mode  - Sets  any  of  the  terminal  modes. 

Saves  tne  cursor  attributes  and  position. 

Select  graphics  character  set. 

Sets  tne  top  and  bottom  margin  of  the  terminal 
scrolling  area. 
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APPENDIX  D 

S Y A T c M Su  3 kG u F j.N c I b R A R ( 

These  subprograms  are  used  tnrou^ht  the  C~'S  but  are 
part  of  either  the  system  Subroutine  ciorary*  or  the  F jkTRAN 
Subprogram  library.  They  provide  various  standard  runctions 
such  as  aguiring  the  current  date  ane  time.  Those  used  are 
listed  and  described  oriefly  below*  ror  more  actaii.es 
information  see  toe  R I~  i.4.  iil^sihQe^  Era  r ' ^ ig^er 

Ggigs-e3y»  and  the  SI~ii  disilbais  ii  SyideCAy. 


uA  i £ - 

returns  the  system  date. 

INDEX 

- Returns  tne  starting  location  of  a string  pattern 
occurring  in  a string  source. 

iGN 

- Integer  transfer  of  sign. 

IT TOUR 

- Transfers  i character  to  the  console  terminal. 

v- T m T u H - Attaches  a specific  multi  terminal. 


M T u T C H 

- Detaches  a specific  multi  teminal* 

nTuET 

- Sets  status  information  for  a specific  terminal. 

PRINT 

- Outputs  an  ASali  string  to  the  terminal. 

SCu  A 

- Inhioits  a ^TaL/C  aoort. 

A Q K T 

- calculates  square  root  of  argument. 

S U a S T R 

- Copies  a substring  from  a specified  strina. 

TIME 

Returns  the  system  time. 

I 


